Android SDK

最后更新时间：2021年6月17日

[TOC]

功能概述

MapGIS Mobile 10.5 for Android是什么

MapGIS Mobile 10.5为Android平台提供了专门的开发包MapGIS Mobile 10.5 for Android，提供一套基于Android原生开发方式实现移动GIS功能的应用程序接口，包括移动二维GIS与三维GIS功能，移动桌面GIS内核一致化，便于开发者打造专业、实用的地图应用。

MapGIS Mobile 10.5 for Android目前提供的移动GIS功能如下：>>查看功能详情

• 地图可视化：基于高效的地图渲染引擎提供强大的地图显示功能，全面支持离在线数据加载，支持多种地图数据的快速显示、流畅操作。不仅支持离线矢量、瓦片数据、三维数据、以及第三方离线切片包；对于在线数据，能快速访问MapGIS地图服务与OGC服务，支持各种第三方公共地图服务，这大大扩展了移动终端的数据来源，同时还支持自定义地图服务；
• 地图管理：提供地图界面控制，地图操作功能和地图文档管理功能，其中地图文档管理支持开发者查看地图的相关信息，图层管理和自定义图层等；
• 地图覆盖物：即自定义图形功能，支持在地图上画点、线、圆、多边形，添加图像，添加文本；
• 地图标注：支持在地图上添加标注，添加标注视图等，可以自定义标注视图（样式、布局等）；
• 要素查询：提供空间查询、属性查询与复合查询方式，支持查询图层要素的属性信息与空间信息，查询结果可以通过标注、列表等方式展示；
• 要素编辑：提供对离在线的地图要素的增、删、改的编辑功能，包括要素的几何信息、属性信息以及要素样式的编辑，提供地图数据同步功能，以及地图增量更新功能；
• 动态数据可视化：动态绘制图表，多样化展现统计分析结果，如折线图、柱状图、饼状图、仪表盘等，还提供散点图、热力图等新型图表，支持时空大数据渲染，可以挖掘数据，辅助决策；
• 专题图：支持统一、单值和分段专题图等，分段专题图支持多字段表达式，可以在桌面工具中预先配置，也可以在移动端通过接口动态配置；
• 空间分析与计算：支持缓冲区分析、叠加分析、裁剪分析、空间关系判断、空间计算、面积距离的量算等；
• 数据转换：提供常用的矢量数据格式shp、KML、GeoJSON的导入与导出功能，支持二次开发用户直接接入这些常用矢量数据，扩大支持本地矢量数据格式的范围，满足更多应用场景的需求；
• 真三维功能：基于高性能的移动三维渲染引擎，提供三维控件（球面与平面），全面支持在线与离线模式，实现了二三维数据的一体化显示、查询、分析，满足移动端真三维应用需要；
• AR功能：GIS与AR融合，基于三维模块提供AR功能；
• 地图工具：可实现放大镜工具、交互绘制工具、测量工具、草图编辑器、卷帘功能等，可在地图上实现交互式操作；
• POI查询：根据用户输入的关键字、类型等条件，寻找到满足条件的兴趣点，支持关键字查询、周边查询、首字母查询等多种POI查询方式；
• 定位功能：提供室内外一体化全面的定位功能，以及地理围栏功能，满足各种应用场景；
• 导航功能：提供路径规划与导航功能，支持室内室外一体化的路径引导，其中路径规划实现通过起点和终点以及偏好设置规划出想要的路径；导航则辅以图文、语音播报等完成路线行进的引导，支持模拟导航与真实导航模式；
• 轨迹自动采集：基于移动设备GPS记录连续的位置，自动采集位置信息形成轨迹，保存为移动端离线矢量数据，支持距离间隔、时间间隔模式采集点，并具备抓路模式；可以进一步处理轨迹数据，如自动平滑，去重、剔除异常点，自动加密和稀疏处理，支持各种应用需求；
• 扩展支持：具有灵活的扩展机制，可自定义扩展接入各种移动GIS功能，支持接入第三方Rest服务资源等。

适用对象

本套SDK接口是提供给那些具有一定Android编程经验和了解面向对象概念的开发者使用。此外，开发者还应该对地图产品有一定的了解。如果您在使用过程中遇到任何问题，或对接口有任何意见或建议，欢迎您随时向我们交流反馈!

兼容性

MapGIS Mobile 10.5 for Android开发的应用能够部署在Android 2.3及以上智能手机、平板电脑和其他智能终端上，支持armeabi、armeabi-v7a、arm64-v8a的cpu架构。

特别提示：若开发使用的targetSdkVersion为Android 23及以上版本，手机的Android系统版本大于等于6.0时，则必须动态申请Android的各种权限，包括文件读取权限等。

版本说明

V 10.5.2.10

此版本对应用终端Android 10及以上系统做了兼容支持，开发时可设置使用targetSdkVersion 29及以上版本，但需要注意以下三个问题：

1.后台获取位置信息的权限变更

问题描述：Android 10以后，后台应用要获取位置信息需要动态申请权限

解决方式：使用MapGis for Android进行二次开发的项目，如果版本是29以上，则需加上如下权限：

<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>

2.兼容文件分区存储

问题描述：Android 10以后，文件存储采用沙箱模式，应用只能看到本应用专有的目录

解决方式：以兼容模式运行，在Mainfiests中设置requestLegacyExternalStorage属性为true

<application android:requestLegacyExternalStorage="true" ... >

3.http网络连接

问题描述：使用http连接时提示“网络连接失败”

解决方式： （1）先在 res下新建一个xml目录，然后创建一个名为：network_config.xml 文件（名字自定）,内容如下：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
  <base-config cleartextTrafficPermitted="true" />
</network-security-config>

（2）然后在Mainfiests appliction标签下配置该属性：

android:networkSecurityConfig="@xml/network_config"

V 10.5.0.10

• 更新为全国产化跨平台内核，具备桌面GIS一致的能力
• 使用HDB高性能文件数据库，三端数据同源，移动端离线数据直接迁移

特别说明：针对V10.5.0.10版本，建议将targetSdkVersion设置为28及以下版本，暂不支持targetSdkVersion 29及以上版本（将在后续更新的版本中支持）。若手机的Android系统版本大于等于10时，暂时也将targetSdkVersion设置为28及以下版本。

二次开发包SDK

MapGIS Mobile 10.5 for Android开发包（SDK）， 包含了Android开发所需的开发库、示例、帮助文档等。基于此二次开发包，结合云开发世界资源中心发布的配套二次开发资源（文档、示例、视频、教程等），帮助您快速开发Android的移动GIS APP。

说明：下载for Android开发包，得到一个对应的压缩资源包（MapGIS_MobileAndroidSDK.zip），将此解压即可。

• 二次开发库：提供了jar和so形式的开发库，基于Java语言的开发，该形式开发库配置简单、使用方便；

• 开发接口示例： 提供2DSample工程源码与其示例数据包，3DSample工程源码与其示例数据包；

• 配套文档资源： 提供MapGIS Mobile 10.5 for Android 程序员参考（API），以及云上的其他文档资源，如平台概述、云授权、数据组织、入门指南、开发指南、常见问题等。

二次开发库

MapGIS Mobile 10.5 for Android向广大开发者提供了jar和so形式的开发库，基于Java语言的开发，该形式开发库配置简单、使用方便。

基于Android的MapGIS Mobile 10.5二次开发，在Android软件架构的基础之上，通过共享库拓展本地框架，同时在应用程序框架层提供扩展jar包，从而使得应用程序层的应用开发者可以在移动端实现GIS功能。

MapGIS Mobile 10.5 for Android的常用程序包简要说明如下：

配套示例

MapGIS Mobile 10.5 for Android的二次开发包提供了功能全面的接口示例，可直接部署到移动端设备（模拟器/真机）体验移动GIS功能，同时借助Sample源码，可以帮助您进行高效开发。

示例使用流程

示例使用说明

1

示例数据配置

将MapGIS Mobile 10.5的示例数据包拷贝到模拟器或真机的SD卡根目录下。

2

APP安装使用

方式一：安装APK（示例包）， 下载全功能接口示例apk，或者单个功能示例apk，拷贝到移动设备（真机或模拟器）上安装使用。此方式安装后初次打开运行APP需要进行二次开发授权验证，请先获得免费开发授权。>>请访问示例中心下载功能示例apk

方式二：使用示例源码， 在Android集成开发工具中打开APP 示例源码，选择模拟器或真机运行，即将APP安装到对应设备。此方式应先安装配置开发环境，并获得免费开发授权。